<!DOCTYPE html PUBLIC '-//W3C//DTD XHTML 1.0 Transitional//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd'>
<html xmlns='http://www.w3.org/1999/xhtml'>
<head>
<title>src/vfs/extfs/helpers/README.uzip</title>
<meta name='robots' content='noindex,nofollow' />
<meta name='generator' content='GLOBAL-6.5.7' />
<meta http-equiv='Content-Style-Type' content='text/css' />
<link rel='stylesheet' type='text/css' href='../style.css' />
</head>
<body>
<!-- beginning of fixed guide -->
<div id='guide'><ul>
<li><a href='#TOP'><img class='icon' src='../icons/first.png' alt='[^]' /></a></li>
<li><a href='#BOTTOM'><img class='icon' src='../icons/last.png' alt='[v]' /></a></li>
<li><a href='#TOP'><img class='icon' src='../icons/top.png' alt='[top]' /></a></li>
<li><a href='#BOTTOM'><img class='icon' src='../icons/bottom.png' alt='[bottom]' /></a></li>
<li><a href='../mains.html'><img class='icon' src='../icons/index.png' alt='[index]' /></a></li>
<li><a href='../help.html'><img class='icon' src='../icons/help.png' alt='[help]' /></a></li>
<li class='standout'><span><a href='../files/src.html'>src</a>/<a href='../files/src--vfs.html'>vfs</a>/<a href='../files/src--vfs--extfs.html'>extfs</a>/<a href='../files/src--vfs--extfs--helpers.html'>helpers</a>/README.uzip</span></li>
</ul></div>
<!-- end of fixed guide -->
<a id='TOP' name='TOP'></a><h2 class='header'><a href='../mains.html'>root</a>/<a href='../files/src.html'>src</a>/<a href='../files/src--vfs.html'>vfs</a>/<a href='../files/src--vfs--extfs.html'>extfs</a>/<a href='../files/src--vfs--extfs--helpers.html'>helpers</a>/README.uzip</h2>
<em class='comment'>/* <img class='icon' src='../icons/n_left.png' alt='[previous]' /><img class='icon' src='../icons/n_right.png' alt='[next]' /><img class='icon' src='../icons/n_first.png' alt='[first]' /><img class='icon' src='../icons/n_last.png' alt='[last]' /><img class='icon' src='../icons/n_top.png' alt='[top]' /><a href='#BOTTOM'><img class='icon' src='../icons/bottom.png' alt='[bottom]' /></a><a href='../mains.html'><img class='icon' src='../icons/index.png' alt='[index]' /></a><a href='../help.html'><img class='icon' src='../icons/help.png' alt='[help]' /></a>&nbsp;<input type='text' readonly onfocus='this.select();' value='+1 src/vfs/extfs/helpers/README.uzip'  /> */</em>
<hr />
<pre>
<a id='L1' name='L1'></a>Overview
<a id='L2' name='L2'></a>========
<a id='L3' name='L3'></a> 
<a id='L4' name='L4'></a>uzip is a module for the extfs Virtual File System (VFS) in
<a id='L5' name='L5'></a>Midnight Commander. It allows browsing, extraction and
<a id='L6' name='L6'></a>modification of zip archives.
<a id='L7' name='L7'></a> 
<a id='L8' name='L8'></a>uzip was written by Oskar Liljeblad. If you find a bug, or know
<a id='L9' name='L9'></a>of an improvement, please email me at osk@hem.passagen.se.
<a id='L10' name='L10'></a> 
<a id='L11' name='L11'></a>License and Copyright
<a id='L12' name='L12'></a>=====================
<a id='L13' name='L13'></a> 
<a id='L14' name='L14'></a>uzip is released under the terms of the GNU General Public License.
<a id='L15' name='L15'></a>uzip is copyright (C) 2000-2001 by Oskar Liljeblad.
<a id='L16' name='L16'></a> 
<a id='L17' name='L17'></a>Requirements
<a id='L18' name='L18'></a>============
<a id='L19' name='L19'></a> 
<a id='L20' name='L20'></a>Info-Zip mode:
<a id='L21' name='L21'></a>  Info-ZIP unzip 5.41 (for listing and extracting files)
<a id='L22' name='L22'></a>  Info-ZIP zip 2.30 (for adding and deleting files)
<a id='L23' name='L23'></a> 
<a id='L24' name='L24'></a>otherwise:
<a id='L25' name='L25'></a>  any unzip
<a id='L26' name='L26'></a>  any zip
<a id='L27' name='L27'></a> 
<a id='L28' name='L28'></a>History
<a id='L29' name='L29'></a>=======
<a id='L30' name='L30'></a> 
<a id='L31' name='L31'></a>2001-08-07  Oskar Liljeblad  &lt;osk@hem.passagen.se&gt;
<a id='L32' name='L32'></a> 
<a id='L33' name='L33'></a>        * Release 1.4.0.
<a id='L34' name='L34'></a>        * Fixed so that files with filenames containing *, ?, [, ]
<a id='L35' name='L35'></a>        and \\ can be extracted or added to zip archives etc. These
<a id='L36' name='L36'></a>        characters has to be escaped once more, because Info-ZIP zip
<a id='L37' name='L37'></a>        and unzip interprets them as wildcards (despite the fact that
<a id='L38' name='L38'></a>        the shell already expands wildcards).
<a id='L39' name='L39'></a> 
<a id='L40' name='L40'></a>2001-03-01  Oskar Liljeblad  &lt;osk@hem.passagen.se&gt;
<a id='L41' name='L41'></a> 
<a id='L42' name='L42'></a>        * Release 1.3.0.
<a id='L43' name='L43'></a>        * Caching of files when listing archives has been fixed. (MC
<a id='L44' name='L44'></a>        would list a directory twice in some cases.)
<a id='L45' name='L45'></a>        * 'strict' is now used. (This is why global variables
<a id='L46' name='L46'></a>        are now initialized using 'my'.)
<a id='L47' name='L47'></a>        * Some code simplifications thanks to more understanding
<a id='L48' name='L48'></a>        of perl :)
<a id='L49' name='L49'></a>        * Minor documentation clarifications.
<a id='L50' name='L50'></a> 
<a id='L51' name='L51'></a>2001-02-21  Oskar Liljeblad  &lt;osk@hem.passagen.se&gt;
<a id='L52' name='L52'></a> 
<a id='L53' name='L53'></a>        * Release 1.2.0.
<a id='L54' name='L54'></a>        * The 'rmdir' extfs command of uzip was modified not to fail
<a id='L55' name='L55'></a>        when deleting directories that doesn't exist. (A different/
<a id='L56' name='L56'></a>        better solution would be to recreate the automaticly deleted
<a id='L57' name='L57'></a>        directories, but that's slower and harder to implement.)
<a id='L58' name='L58'></a>        Strangely, the zip man page does not mention this delete-
<a id='L59' name='L59'></a>        empty-directories behavior.
<a id='L60' name='L60'></a> 
<a id='L61' name='L61'></a>2000-10-31  Oskar Liljeblad  &lt;osk@hem.passagen.se&gt;
<a id='L62' name='L62'></a> 
<a id='L63' name='L63'></a>        * Release 1.1.0.
<a id='L64' name='L64'></a>        * mczipfs_copyin: Fixed order of arguments.
<a id='L65' name='L65'></a>        * safesystem, safeticks: Improved error handling.
<a id='L66' name='L66'></a>        * mczipfs_copyout: Now allows error code 11, and redirects
<a id='L67' name='L67'></a>        stderr to /dev/null.
<a id='L68' name='L68'></a> 
<a id='L69' name='L69'></a>2000-10-29  Oskar Liljeblad  &lt;osk@hem.passagen.se&gt;
<a id='L70' name='L70'></a> 
<a id='L71' name='L71'></a>        * Release 1.0.1.
<a id='L72' name='L72'></a>        * Fixed bug causing files with special permission not to
<a id='L73' name='L73'></a>          be listed.
<a id='L74' name='L74'></a> 
<a id='L75' name='L75'></a>2000-10-29  Oskar Liljeblad  &lt;osk@hem.passagen.se&gt;
<a id='L76' name='L76'></a> 
<a id='L77' name='L77'></a>        * Release 1.0.0: First version.
<a id='L78' name='L78'></a> 
<a id='L79' name='L79'></a>Differencies between new (Perl) and old (sh/AWK) uzip
<a id='L80' name='L80'></a>=====================================================
<a id='L81' name='L81'></a> 
<a id='L82' name='L82'></a>The script is written purely in Perl, which (hopefully) means
<a id='L83' name='L83'></a>faster execution and cleaner code.
<a id='L84' name='L84'></a> 
<a id='L85' name='L85'></a>Listing is done only with either zipinfo or unzip,
<a id='L86' name='L86'></a>not both at the same time. Previously unzip would be used
<a id='L87' name='L87'></a>if the archive contained non-unix file listings (after
<a id='L88' name='L88'></a>zipinfo was run). Now there is an option to choose which
<a id='L89' name='L89'></a>one to use (zipinfo is the default and preferred). This
<a id='L90' name='L90'></a>should make listing of non-unix archives faster.
<a id='L91' name='L91'></a> 
<a id='L92' name='L92'></a>Files appearing before their parent directories in the listings
<a id='L93' name='L93'></a>are now cached and printed later. This fixes a bug that would
<a id='L94' name='L94'></a>cause some directories to be listed twice.
<a id='L95' name='L95'></a> 
<a id='L96' name='L96'></a>Temporary filenames are chosen better. That is, they are
<a id='L97' name='L97'></a>generated using tmpnam(3). Previously, hardcoded filenames
<a id='L98' name='L98'></a>(in the current directory) would be used.
<a id='L99' name='L99'></a> 
<a id='L100' name='L100'></a>The error messages are much better. Errors are checked for
<a id='L101' name='L101'></a>(hopefully) all functions that can fail.
<a id='L102' name='L102'></a> 
<a id='L103' name='L103'></a>The copyin command no longer makes a copy of the file before
<a id='L104' name='L104'></a>adding it. Instead it makes a temporary directory in which
<a id='L105' name='L105'></a>a symlink to the original file is placed. This should speed
<a id='L106' name='L106'></a>up addition considerably.
<a id='L107' name='L107'></a> 
<a id='L108' name='L108'></a>The run command is supported.
<a id='L109' name='L109'></a> 
<a id='L110' name='L110'></a>The theoretic commands "mklink" and "linkout" are supported.
<a id='L111' name='L111'></a>However, MC extfs doesn't support these so they are rather
<a id='L112' name='L112'></a>useless at the moment.
<a id='L113' name='L113'></a> 
<a id='L114' name='L114'></a>Known problems and Unsupported features
<a id='L115' name='L115'></a>=======================================
<a id='L116' name='L116'></a> 
<a id='L117' name='L117'></a>Files added to the archive get listed with a+x permissions in MC.
<a id='L118' name='L118'></a>This appears to be a problem with the MC extfs, and (probably) not uzip.
<a id='L119' name='L119'></a>(It is only temporary though. When restarting MC and reading the
<a id='L120' name='L120'></a>archive, the files will no longer be listed as executable.)
<a id='L121' name='L121'></a> 
<a id='L122' name='L122'></a>Extracted files do not have the same modification/access date as
<a id='L123' name='L123'></a>in the archive. The same applies for permissions and ownership.
<a id='L124' name='L124'></a>Fortunately MC extfs will set these attributes based on the file
<a id='L125' name='L125'></a>listings.
<a id='L126' name='L126'></a> 
<a id='L127' name='L127'></a>Interpretation of special information ("central-directory extra field")
<a id='L128' name='L128'></a>in zip archives. This is used to store information such as universal
<a id='L129' name='L129'></a>time and unix UID/GID on files.
<a id='L130' name='L130'></a> 
<a id='L131' name='L131'></a>It would be nice if listing archives with symbolic links was faster.
<a id='L132' name='L132'></a>Unzip has to be executed once for each link. This is because the
<a id='L133' name='L133'></a>symbolic link file must be extracted in order to get the link
<a id='L134' name='L134'></a>destination.
<a id='L135' name='L135'></a> 
<a id='L136' name='L136'></a>-
</pre>
<hr />
<a id='BOTTOM' name='BOTTOM'></a>
<em class='comment'>/* <img class='icon' src='../icons/n_left.png' alt='[previous]' /><img class='icon' src='../icons/n_right.png' alt='[next]' /><img class='icon' src='../icons/n_first.png' alt='[first]' /><img class='icon' src='../icons/n_last.png' alt='[last]' /><a href='#TOP'><img class='icon' src='../icons/top.png' alt='[top]' /></a><img class='icon' src='../icons/n_bottom.png' alt='[bottom]' /><a href='../mains.html'><img class='icon' src='../icons/index.png' alt='[index]' /></a><a href='../help.html'><img class='icon' src='../icons/help.png' alt='[help]' /></a>&nbsp;<input type='text' readonly onfocus='this.select();' value='+136 src/vfs/extfs/helpers/README.uzip'  /> */</em>
</body>
</html>
